home *** CD-ROM | disk | FTP | other *** search
/ Network Support Library / RoseWare - Network Support Library.iso / apidev / logdis.arc / LOGDISP.DOC < prev    next >
Text File  |  1990-09-06  |  4KB  |  101 lines
  1. LOGDISP - A Novell Netware Display Utility
  2. * Author - William Stackpole
  3.            Puget Sound Naval Shipyard
  4.            Dept of the Navy
  5.            Code 114.4  Bldg 443
  6.            Bremerton, Wa 98314-5000
  7. * Date   - 08/29/90
  8. * Written in MSC v5.1 
  9.  
  10.   Purpose:
  11.            Displays an ASCII text file if a specified period of time has
  12.            passed since the user's last login.
  13.  
  14.     Usage:
  15.            To limit system information or news files to once a day displays
  16.            or to remind users that they need to login more frequently to
  17.            check their E-Mail, etc.
  18.           
  19.    Syntax:
  20.            LOGDISP [nnn] [d:][\path\]filename.ext [-w[tt]] [-n]
  21.            
  22.            Where:
  23.              nnn is the time period in minutes that must have passed since
  24.            the last login before the text file is displayed.  The default
  25.            is 240 minutes (4 hours).
  26.  
  27.              [d:] is the optional drive or volume designator.
  28.  
  29.              [\path\] is the optional directory path.
  30.  
  31.              filename.exe is the text filename and extension.
  32.  
  33.              [-w] is the wait option.  If specified, LOGDISP will pause for
  34.            20 seconds or until a key is pressed which ever comes first.
  35.            The [tt] option can be used to alter the wait time.  [tt] is the
  36.            time in seconds you want LOGDISP to wait.  A value of 0 will cause
  37.            LOGDISP to wait until a key is pressed (forever).  
  38.  
  39.              [-n] prevents the last login data file from being updated.  This
  40.            is necessary if you are using LOGDISP more than once during a script,
  41.            otherwise the login data file would be set to the current time and
  42.            the second, third, etc. files would never be displayed.
  43.            
  44.    Outputs:
  45.    
  46.            Text file to screen [stdout] if duration has passed OR text file
  47.            has been updated since the user's last login.
  48.            
  49.            ERRORLEVEL 0 is no errors were encounted during execution.
  50.            
  51.            ERRORLEVEL 1 for any of the following reasons:          
  52.  
  53.            Unknown option.
  54.            Bad or missing command line parameter.
  55.        Invalid time parameter (1-32768).
  56.             Error opening text file to be displayed.
  57.            Error reading text file to be displayed.
  58.            Bad or missing text file specification
  59.            Error opening LST$LOG.DAT file.
  60.            Error reading LST$LOG.DAT file.
  61.            Writing LST$LOG.DAT file.
  62.  
  63.  
  64.  
  65. /* Update Log  */
  66.  
  67.   Attempt to use last login parameter failed because attribute is updated
  68.   prior to the execution of the script file.  LOGDISP now creates the file
  69.   LST$LOG.DAT in the user's MAIL box and uses it to determine the last login.
  70.   The file contains a single long interger with a value equal to the minutes
  71.   passed from Midnight January 1, 1970 to the last login time.
  72.   
  73. Examples:
  74.   Inserting this line in your system login script will cause the system news
  75. file (sysnews.txt) to be displayed only if it has been 4 hours since the 
  76. user last logged in.  Pauses for 20 seconds.
  77.  
  78.   #sys:\public\logdisp sys:public\messages\sysnews.txt -w
  79.   
  80.   Inserting this line in your system login script will display a reminder
  81. message to anyone who hasn't logged in in three days. Use it to remind users
  82. to check their E-Mail everyday.  Forces them to acknowledge by pressing a key.
  83.  
  84.   #sys:\public\logdisp 4320 sys:public\messages\remind.txt -w0
  85.  
  86.   Inserting these lines in your system login script will cause the system
  87. information file (sysinfo.txt) to be displayed only if it has been 8 hours
  88. since the user's last logged in and the daily system news file (sysnews.???)
  89. if it has been 4 hours since the user's last logged in.
  90.   Pauses for 20 seconds for sysinfo and 15 for sysnews viewing.
  91.  
  92.   #sys:\public\logdisp 480 sys:public\messages\sysinfo.txt -w -n
  93.   #sys:\public\logdisp sys:public\messages\sysnews.%DAY_OF_WEEK -w15
  94.  
  95.   
  96. This program was developed for the federal government using public funds and
  97. is therefore public property.  You are free to use, copy and distribute this
  98. program provided you do not charge for other than the cost of duplication.
  99. The program must be distributed with this doc file.
  100.  
  101.